Welcome! We believe that like us, you have many tasks and just too little time to manage them, sort them, filter them or just keep them in order. Is there a solution? Yes!
It’s Keep It Tidy.
Or KIT.
KIT is a desktop app that helps users manage their tasks and it is the one and only taskmanager you will ever need. With a simplistic design of UI and powerful functionalies embedded, KIT is capable of executing your instructions swiftly. On top of that, KIT is keyboard friendly, thereby saving you the trouble of ever moving the mouse and clicking.
Now, let’s get you started!
1.8.0_60 or later installed in your Computer.Having any Java 8 version is not enough.
This app will not work with earlier versions of Java 8
KIT.jar from here.Double-click the file to start the app. The GUI should appear in a few seconds.
(Optional) You can choose to login to your Google Calendar.
After you have logged in, it looks something like this. >
help and pressing Enter will open the help window.list : lists all task
adddo 2103 project r/waiting for john's reply s/03-03-2017 l/nus soc t/school : adds a task named do 2103 project to KIT.
delete1 : deletes the task with index 1 shown in the current list
exit : exits the app
Command Format > > * Words in UPPER_CASE are the parameters. > * Parameters in [SQUARE_BRACKETS] are optional. > * Parameters with ... after them can have multiple instances. > * Parameters can be in any order.
helpFormat: help [COMMAND], h [COMMAND], man [COMMAND], manual [COMMAND]
- If COMMAND is entered, displays the help message for that specific command
- If COMMAND is not entered, displays this user guide in a new window.
- Tips: You can also bring up the user guide by pressing F1.
Example:
man add > helpfFormat: helpformat, helpf, summary, hf
- Helpf shows a quick summary of command formats.
- Tips: You can also bring up the help window by pressing F3.
addDescription: Adds a task to KIT. New tasks are not done by default.
Format: add NAME [r/REMARKS] [s/STARTDATE] [e/ENDDATE] [l/LOCATION] [t/TAG]...
- If you need to type the character / anywhere in the input, put a before it to avoid problems such as, t/ getting recognized as tag. eg. carrot/cabbage
- Tasks can contain any number of tags (including 0).
Here are some examples:
add do 2103 project r/waiting for john’s reply e/next tuesday l/nus soc t/schooladd buy presents s/two week before christmas e/christmas eve l/town t/shoppingadd buy groceries r/cabbage and broccoli s/this weekend t/personaladd feed the cat\/dog t/personal t/family e/tomorrow 8am
cat/dog is correctly captured and displayed.KIT has an intelligent processer that interprets your phrases and sentences about time, date and deadline.
Here is a table of interpretation for your convenience.
| Date Format | Example | KIT’s interpretation |
|---|---|---|
| Month/day | 10/19 | Oct 19 of the current year |
| Day Month | 6 Apr | Apr 6 of the current year |
| Month Day | Apr 6 | Apr 6 of the current year |
| Day of the Week | Mon, Monday | The upcoming Monday |
| Relative date | Yesterday, today, tomorrow, two weeks from now | Corresponding dates relative to today |
| Holidays | New Year, Christmas | The dates of the holiday of the current year |
- If you are adding a date of the current year, you can leave out the year because dates without specified year are assumed to be the current year. See the first 3 entries of the Date Format Table
- You can input time as HH:mm in 24 hour format or hh:mm am/pm.
- Times without am/pm are assumed to be in 24 hour format.
- You may include both date and time, date only, time only or even none at all.
listDescription: Shows a list of tasks in KIT depending on chosen criterion.
Format: list [CRITERION], ls [CRITERION], l [CRITERION]
done : display the list of all tasks that are done. notdone or undone : display the list of all tasks that are not done. floating or float : display the list of all tasks that have no start date and no end date.
If no criterion is specified, all tasks will be listed.
Examples: * ls : display all task. * list done : display all done task. * l notdone : display all notdone task. * ls float : display all floating task.
list tagIf you want to see all tasks with a particular tag only, say work, you can use the list tag function.
Description: Shows a list of task by the specified tag.
Format: list tag TAGNAME, ls tag TAGNAME, l tag TAGNAME
Example:
list tag work
This displays all task with the tag work.
doneNow that you have completed a task, you can mark it as done by using the done function.
Description: Marks the task at the specified INDEX as “Done”.
Format: done INDEX, d INDEX
- The index refers to the number shown beside the task name.
- The index must be a positive integer 1, 2, 3, …
Tip : You can use the
list doneorlistcommand to see the tasks you have marked as done. Task with green names and a tick are done tasks.
undoneYou can easily mark it as “Not Done” again.
Description: Marks the task at the specified INDEX as “Not Done”.
Format: undone INDEX, notdone INDEX, ud INDEX, nd INDEX
- The index refers to the number shown beside the task name.
- The index must be a positive integer 1, 2, 3, …
done or undone on the same task does not change it’s status, i.e. done an already done task does not change it’s status.deleteIf you would like to remove a task from KIT, simply use the delete function.
Description: Deletes the task with specified index from KIT.
Format: delete INDEX
- Deletes the task with the specified
INDEX.- The index refers to the index number shown in the listing.
- The index must be a positive integer 1, 2, 3, …
Examples:
delete 22 in the current listing in KIT.undoYou can retract it by using the undo command.
Description: Undo the last command.
Format: undo, uhoh
redoJust in case you changed your mind, you can also reverse your undo by using the redo command.
Description: Redo the last undo.
Format: redo
- Able to redo up to 10 times.
- If you make any new commands right after you undo, you will not be able to do any more redo.
Undo and Redo basically works similarly to the page back and page forward button in your browser.
editThe edit command allows you to edit the details of a task.
Description: Edits an existing task in KIT.
Format: edit INDEX [NAME] [r/REMARKS] [s/STARTDATE] [e/ENDDATE] [l/LOCATION] [t/TAG]...
- At least one of the optional fields must be provided.
- Existing values will be updated to the input values.
- When editing tags, the existing tags of the task will be removed i.e adding of tags is not cumulative.
- You can remove all the task’s tags by typing
t/without specifying any tags after it.
Examples:
edit 1 r/doing edit command l/homefinish up user guide and home respectively. > findKIT has an efficient find command that can help. Use it along with any keyword or date you can recall that is related to that task.
Description: Finds task whose names or remark contains the given keywords.
Format: find KEYWORD [MORE_KEYWORDS], f KEYWORD [MORE_KEYWORDS]
- The search is case insensitive. e.g
projectwill matchProject- The order of the keywords does not matter. e.g.
do projectwill matchproject do- All fields of the task are searched, i.e. name, remark and etc, basically every detail of the task is being searched.
- Substrings will be matched. e.g.
projectwill matchprojects- Task matching every keyword will be found. e.g. keywords
biology projectwill match the task ofdo biology projectand not the task ofdo physics project(does not containbiology).
Examples:
find homework
find poster Apr 6
findexactfindexact allows you to do that.
Description: Finds task that contains words that are full matches of all the keyword(s).
Format: findexact KEYWORD..., fexact KEYWORD..., finde KEYWORD..., fe KEYWORD...
- The search is the similar to
findexcept it does not search for substring matches and does not search for dates. e.gdo projectwill matchdo School projectbut notdo School projects(projectsdoes not matchproject)
KIT provides support for Google Calendar users.
To use Google Calendar with KIT, we first require your permission for access to your Google Calendar. Note: Google Calendar related commands requires the internet and a Google Calendar account to work.
- The request will automatically open in your default browser.
- Log in to your Google account and approve our request to access your calendar.
- You only need to do this for the first time.
ggYou can import your google calendar with the getgoogle command.
Description: Add your upcoming Events from your Google Calendar to KIT.
Format: getgoogle, gg > >
- This command will only grab upcoming Events and ignore duplicate Events.
pgWith postgoogle, you are able to add a task from KIT as an Event to your Google Calendar. It also updates tasks that are added before.
Description: Add or update the specified task to your Google Calendar.
Format: postgoogle [INDEX], pg [INDEX]
- If INDEX is specified and correct, adds/updates the selected task to calendar.
- If INDEX is not specified, adds/updates all displayed tasks to calendar.
- This will not add any duplicate tasks to your google calendar.
- Note: Any events in a calendar will have both start and end dates. Similarly only tasks with start and end dates can be added to your google calendar.
smartaddsmartadd.You can add a new event to both your calendar and KIT usingsmartadd. This command is flexible and allows you to add a task’s location and date details without using the prefixes.
Description: Flexibly adds a task without specifying prefixes for date and location to both KIT and your calendar.
Format: sa DESCRIPTION [r/REMARK] [t/TAG]…
- DESCRIPTION is where you can specify the task name, location and date details.
Example:
sa meet friends for dinner in clementi at 6pm t/friendssa project meeting at 2pmsa design poster with team in meeting room r/share my new ideas with teamSome tips for using the Smart Add command:
sa watch movie 3pm for 2 hourssa watch movie 3pm-5pmNote: KIT will give the best interpretation of the given description, however, this may not always be accurate, especially for ambiguous descriptions.
For example, sa Meeting at Wednesday Cafe.
In this case, either ‘Wednesday Cafe’ is the actual location and the date is not specified. Or, it could also be interpreted as meeting on Wednesday at ‘Cafe’.
If the input is ambiguous, we recommend you to use the add command to clearly specify the location, date and etc.
clearJust use clear.
Description: Clears all entries from KIT.
Format: clear
exitDescription: Exits the program.
Format: exit
saveYou can do so using the save function.
Description: Specify location of save file.
Format: save PATHNAME
In KIT, you data are saved automatically after a change has been made. There is no need to save manually.
load function can load your data from a specified location.
Description: Loads a file from the specified location.
Format: load PATHNAME
changetheme allows you to change the colors and appearances of KIT.
Description: Changes the theme of KIT to the requested theme.
Format: changetheme [THEMENAME] > >
- After each successful
changethemecommand, you will have to restart KIT to view the changes.- If THEMENAME is specified and correct, KIT will change its theme and after restart you will see the changed theme.
- KIT currently supports three themes: Default, Light and Dark.
In KIT, we provide shortcuts which are activated with different keyboard combinations.
Description: Fills the command box with specific command.
Example format: Ctrl + Alt + A This will fill the command box with “add”.
- Shortcuts is temporary disabled when you are using google calendar as it is opened in a separate window. Click on KIT to use shortcuts again!
Q: Does KIT support Windows 10?
A: Yes! KIT works as long as you have Java version 1.8.0_60 or later.
Q: Will my tasks be saved after I close the application?
A: Yes. Your data is saved after every command, so you can safely exit KIT when you are done. There is not need to manually save your data.
Q: Can I have two tasks with the same name?
A: Sure, tasks with same names are allowed, as long as at least one of their fields is different. That being said, tasks with completely same details are not allowed. Completely same details refer to same name, location, start date, end date and remark.
Q: I accidentally created two exact same tasks, how do I remove just one of them?
A: If you just added the task,meaning the most recent command is the add command, you can do so by typing undo. Otherwise, you can use find or list to search for the duplicate tasks and delete one of them. The other task will remain in KIT. Instructions on these commands can be found in the respective section of the commands.
Q: Can I manually edit the storage file?
A: Yes, you can. It is a xml file called kit.xml. It can be found under data.xml by default. Be careful in making changes to it if you are unfamiliar with XML, KIT will not be able to read your data if the format is invalid and will start with an empty KIT.
Q: I use two computers. Can I transfer my data between the two computers?
A: Yes, you can! Your data are saved in a file called kit.xml. Just copy this file to your computer and place in under data.xml. You can change the file location later using the save command.
Q: It’s troublesome to constantly transfer my data between two computers, is there any way for it to synchronize automatically?
A: Sorry, we currently do not support automatical synchronization. However, if you are using Dropbox, you can specify folders that will automatically synchronize through Dropbox. This means that you can use the save command to specify your save location in your Dropbox folder and thus get synchronization.